.. _cemIxSpeedPattern_Set:

cemIxSpeedPattern_Set
=====================
---------------------


SYNOPSIS
--------


.. code-block:: none

  LONG cemIxSpeedPattern_Set(
    LONG MapIndex,
    LONG IsVectorSpeed,
    LONG SpeedMode,
    DOUBLE Vel,
    DOUBLE Acc,
    DOUBLE Dec
  )



DESCRIPTION
-----------


- cemIxSpeedPattern_Set 함수는 “기본보간제어”의 이송 속도에 대한 환경을 설정합니다. 
- 사용자가 지정한 작업 속도는 “IsVectorSpeed”의 설정 값이 ‘1(CE_TRUE)’이면 벡터 속도 모드(Vector Speed Mode), ‘0(CE_FALSE)’이면 마스터 속도 모드(Master Speed Mode)가 적용됩니다. 
- “벡터 속도 모드”에 대한 자세한 내용은 아래의 “REFERENCE” 항목을 참조하십시오.



PARAMETER
---------


- MapIndex : 맵 번호(Map index). 이 맵번호를 사용하기 전에 먼저 cemIxMapAxes 함수를 통하여 해당 맵 번호에 유효한 축들이 맵핑 되어 있어야 합니다. 

- IsVectorSpeed : 마스터 속도 모드 또는 벡터 속도 모드를 설정 혹은 반환합니다. 

- SpeedMode : 가감속 모드를 설정 혹은 반환합니다.

- Vel : 마스터 속도 모드 일 때는 기준 작업 속도의 비율(%)을, 벡터 속도 모드 일 때는 PPS 단위를. 사용하여 작업 속도를 설정 혹은 반환합니다. 

- Acc :  마스터 속도 모드 일 때는 기준 가속도의 비율(%)을, 벡터 속도 모드 일 때는 PPS 단위를. 사용하여 가속도를 설정 혹은 반환합니다. 

- Dec : 마스터 속도 모드 일 때는 기준 감속도의 비율(%)을, 벡터 속도 모드 일 때는 PPS 단위를. 사용하여 감속도를 설정 혹은 반환합니다. 




RETURN VALUE
------------

+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+



.. note::
  보간 작업 속도를 벡터 속도로 설정해야만 하는 특별한 경우를 제외하고는 보간 작업 속도를 마스터 속도로 설정하는 것이 모터의 최대속도를 활용하는데 있어서 편리합니다.




.. note::
  마스터 속도 모드(Master Speed Mode)로 보간 작업 시에는 각 축의 속도가 각 축의 이송거리에 비례하여 자동으로 설정됩니다.
  
  이때 cemIxSpeedPattern_Set 함수의 WorkSpeed 매개변수를 통하여 지정되는 보간 작업 속도는 마스터 축의 작업 속도로 적용됩니다.




.. note::
  각 보간 이송시에 이송거리가 가장 큰 축을 “마스터 축” 이라고 하며 마스터 축의 속도를 “마스터 속도”라 합니다. 
  
  각 보간 이송시에 마스터 축의 속도는 사용자가 지정한 보간 작업속도로 설정되며, 마스터 축 이외의 다른 축의 속도는 마스터 축과 해당 축의 이송 거리 비에 따라서 자동으로 설정됩니다.